home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / X11 / xmmix-1.1 / README < prev    next >
Encoding:
Text File  |  1995-07-05  |  6.6 KB  |  200 lines
  1. #
  2. # @(#)README    2.4 95/05/12
  3. #
  4. # xmmix - Motif(tm) Audio Mixer
  5. #
  6. # by Ti Kan
  7. #
  8.  
  9.  
  10. INTRODUCTION
  11. ------------
  12.  
  13. Xmmix is a sound mixer utility for the X Window System using the
  14. OSF/Motif interface.  It requires the "VoxWare" sound driver by
  15. Hannu Savolainen (hannu@voxware.pp.fi), also known as the Linux
  16. sound driver.  See notes below about how to get VoxWare.
  17.  
  18. This version of xmmix has been tested by the author with VoxWare
  19. version 2.4, 2.5, 2.90 and 3.0.  It is expected to work with earlier
  20. and future versions.
  21.  
  22. The OS platforms supported by xmmix is the same as those supported
  23. by VoxWare, which includes several UNIX variants for the Intel x86
  24. PC:
  25.     Linux
  26.     FreeBSD
  27.     NetBSD
  28.     SCO UNIX and Open Desktop
  29.     UNIX SVR4.2 (Novell UnixWare and others)
  30.  
  31. It should be fairly easy to port VoxWare to other PC UNIX
  32. platforms.
  33.  
  34. Likewise, the sound cards supported by xmmix are those that
  35. VoxWare supports.  Currently, this includes:
  36.  
  37.     Adlib
  38.     Creative Labs Sound Blaster series
  39.     Media Vision Pro Audio Spectrum 16
  40.     Media Vision Jazz16 based soundcards (ProSonic, 3D etc.)
  41.     Gravis UltraSound
  42.     Gravis UltraSound MAX
  43.     Gravis UltraSound with 16 bit sampling daughter card
  44.     Roland MPU-401
  45.     Microsoft Windows Sound System
  46.     COVOX SoundMaster II
  47.     ECHO-PSS (cards based on the PSS architecture by Analog Devices.
  48.               Including Orchid SW32, Cardinal DSP16 among others).
  49.     MediaTriX AudioTriX Pro
  50.     Ensoniq SoundScape
  51.     SoundMan Wave
  52.     and others
  53.  
  54. Not all versions of VoxWare supports all of these cards.
  55. Please refer to the VoxWare documentation for further details.
  56. Comments and questions about the VoxWare driver and utilities
  57. should be directed to "hannu@voxware.pp.fi".
  58.  
  59. This distribution now comes with several 32x32 pixmap files
  60. suitable for use as an xmmix desktop icon:
  61.  
  62.     xmmix.icon - for Novell UnixWare
  63.     xmmix_a.px - for SCO Open Desktop (XPM2 format)
  64.     xmmix_b.px - for SCO Open Desktop (XPM2 C format)
  65.     xmmix.xpm  - for other systems that use XPM format
  66.  
  67. You can use the appropriate icon setup utilities under each of
  68. these environments to create an xmmix icon (with which you can use to
  69. launch xmmix).
  70.  
  71. Comments, suggestions, and bug reports about xmmix are very welcome!
  72. Write to "ti@amb.org".
  73.  
  74. If you have a CD-ROM drive, you are invited to try a full-featured
  75. X11/Motif CD Audio Player utility that I wrote.  It's called "xmcd"
  76. and supports many UNIX OS platforms and CD-ROM drives.  Xmmix and
  77. xmcd makes an ideal pair in your multimedia system.  A non-X
  78. command line CD player "cda" is also included in the xmcd package.
  79. See notes below about the anonymous FTP location.
  80.  
  81.  
  82. WHERE TO GET XMMIX
  83. ------------------
  84. The source code release of xmmix v1.1 is available via
  85. Internet anonymous FTP.  Location:
  86.  
  87.     (Instructions)
  88.     ftp.x.org:/contrib/applications/xmmix/xmmix-1.1.README
  89.     (gzip'd tar archive)
  90.     ftp.x.org:/contrib/applications/xmmix/xmmix-1.1.tar.gz
  91.  
  92. The package require the "gunzip" (GNU unzip) utility to uncompress.
  93. The source code to gzip/gunzip can be found on various FTP sites
  94. (such as prep.ai.mit.edu:/pub/gnu).
  95.  
  96.  
  97. WHERE TO GET VOXWARE
  98. --------------------
  99.  
  100. VoxWare files can be obtained via anonymous FTP from the following
  101. directory:
  102.  
  103.     sunsite.unc.edu:/pub/Linux/kernel/sound
  104.  
  105.  
  106. WHERE TO GET XMCD
  107. -----------------
  108.  
  109. Xmcd files can be obtained via anonymous FTP from the following
  110. directory:
  111.  
  112.     ftp.x.org:/contrib/applications/xmcd
  113.  
  114.  
  115. BUILD INSTRUCTIONS
  116. ------------------
  117.  
  118. You must have X11R4/Motif 1.1 or later to build xmmix.  Xmmix has
  119. been successfully built under X11R4 with Motif 1.1, and X11R5 or
  120. X11R6 with Motif 1.2 or Motif 2.0.
  121.  
  122. If you are running Motif 1.1, I recommend version 1.1.4 or later.
  123. Also, you must have an ANSI C compatible compilation environment.
  124.  
  125. Xmmix can be built using the native X libraries that are supplied with
  126. your OS release.  If you have XFree86 installed, you can also build
  127. xmmix using the libraries from the XFree86 distribution.  Make sure
  128. you use the right set of X include files to match!  Motif is not a
  129. part of the XFree86 package, so you will need to get it separately.
  130. Motif is available from various third party vendors for those OS
  131. platforms that do not come standard with the libraries and headers.
  132. If you cannot find a commercial Motif product for your platform
  133. you can also build the Motif library from the OSF sources (if you
  134. have the source license).
  135.  
  136. If your system has imake (most supported systems do), use these
  137. steps to build xmmix:
  138.  
  139.     1. Take a look at the Imakefile, read the comments, and make
  140.        changes as appropriate.  Pay special attention to the
  141.        comments pertaining to the LOCAL_LIBRARIES=XmClientLibs
  142.        line.  You may need to change it in order to successfully
  143.        compile xmmix.
  144.     2. Type "xmkmf" (or "imake -DUseInstalled -I/usr/lib/X11/config")
  145.     3. Type "make depend" (this step is required only if you intend
  146.        to modify the source code or header files).
  147.     4. Type "make"
  148.     5. Type "make install" to install the binary and app-defaults file.
  149.     6. Type "make install.man" to install the man page.
  150.  
  151. If your system does not have imake, use these steps to build xmmix:
  152.  
  153.     1. Type "cp Makefile.std Makefile"
  154.     2. Edit Makefile.  You will most certainly need to make some
  155.        changes in this file to make things compile on your OS
  156.        platform.
  157.     3. Type "make"
  158.     4. Type "make install" to install the binary and app-defaults file.
  159.     5. Type "make install.man" to install the man page.
  160.  
  161.  
  162. NOTES
  163. -----
  164.  
  165. On some systems, there appears to be a problem with the vendor
  166. shell widget class in the shared Motif library.  The symptom is
  167. the following message printed on stderr:
  168.  
  169.     Error: attempt to add non-widget child "dsm" to parent
  170.     "xmmix" which supports only widgets
  171.  
  172. Rearranging the order of the Motif and X libraries linked may
  173. alleviate this problem, and re-linking with the static Motif
  174. library instead of the shared version usually solves this problem.
  175.  
  176. If you get messages similar to these when you start xmmix:
  177.  
  178.     Warning: translation table syntax error: Unknown keysym name: osfActivate
  179.     Warning: ... found while parsing '<Key>osfActivate: BulletinBoardReturn()'
  180.     Warning: translation table syntax error: Unknown keysym name: osfCancel
  181.     Warning: ... found while parsing '<Key>osfCancel: BulletinBoardCancel()'
  182.     etc...
  183.  
  184. These messages are displayed when the LIBDIR/XKeysymDB file is not
  185. installed on your system (where LIBDIR is typically /usr/lib/X11).
  186. A XKeysymDB file is supplied with the xmmix release.  When the
  187. XKeysymDB is installed in the proper location this problem should
  188. go away.
  189.  
  190.  
  191. ACKNOWLEDGEMENTS
  192. ----------------
  193.  
  194. Companies names and product names appearing in this file are each
  195. trademarks of the respective company.  The names are for identification
  196. purposes only.  This software and its author are not affiliated with any
  197. of these companies.
  198.  
  199.  
  200.